WebWork支持的视图 - JSP
JavaServer Pages (JSP)是WebWork(WW)支持的重要视图技术. 本节提供将JSP作为WebWork的一项视图技术的相关知识.参考内容
也可以查看WebWork 2 UI标签指南.
背景
那么什么是JSP呢? 从技术角度来看, JSP是"一个有Web开发人员创建的包含JSP技术特定的标签, 声明和脚本, 并与其它静态标签(HTML or XML)组合而成的页面. JSP页面使用扩展名.jsp; 这通知web服务器使用JSP引擎处理页面上的元素." 更多信息参见JSP文档.
另外, JSP"提供简单, 快速的创建显示动态生成内容的web页面的方法. JSP规范, 由Sun领导在一个行业领域制定, 定义了服务器和JSP页面的交互情况, 描述了页面的格式和语法." 更多信息参见JSP文档.因此你可以创建第一个JSP并部署到Web服务器中. 当用户第一次访问页面时, servlet容器如Tomcat将把JSP编译成Servlet, 并用它绘制Web页面. 那么, 如果最终结果是servlet, 为什么不直接编写servlet? 因为Servlet不是从Web内容中抽象Web表示的有效方式. 在早期, 人们只使用Servlet编写Web页面. 开发者可以使用Serlet动态输出HTML代码. 典型办法是输出HTML代码 - out.write("<HTML>..);. 对于维护而言这种方法简直是噩梦, 且开发成本很大, 因为它需要一个Java开发人员.
JSP技术出现后, 开发者可以使用者一新技术作为表示层. 早期的JSP规范有限地支持定制标签, 因此早期开发这使用脚本和JavaScript创建动态站点. 混合使用Java和HTML并不那么理想, 因为Java代码包含在标签中. 这使JSP代码难以阅读理解. 对于简单的站点这种方法可以工作的很好, 但不适于复杂站点. 复杂站点需要一种可管理, 可维护的方式抽象设计和逻辑.目前JSP已经成熟了, 对定制标签提供强大的支持. 开发者可以编写定制标签库来实现简单或复杂的任务. 定制标签使用与HTML和XML一致的简单语义格式抽象功能. 使用编写良好的JSP标签, 开发者可以不使用Java代码来开发和维护复杂站点.
WebWork的JSP标签
最初编写一个JSP标签是令人畏缩的任务, 但不用担心, WebWork提供了扩展标签库来简化Web站点开发. 标签库分成非UI标签 and UI标签两部分. 两者之间主要区别是, UI标签包含一个隐含JSP模版来绘制HTML表单空间或一组HTML标签产生组合输出结果如table. 这些模版时缺省的并可以满足开发要求. 但是如果你有其他需求, WebWork也提供了使用你自己的模版替代缺省模版的能力. 另外, 你也可以将这些模版组织在一个目录下作为一个主题引用.
主题提供了为站点更换外观(skin)的能力. 一套外观不仅仅意味着不同的图形, 颜色等. 还意味着不同视图技术对应的不同视觉效果. 例如, 你可以为WAP, HTML和DHTML分别定义主题.非UI提供对流程控制, 国际化, WebWork活动, 迭代, 文本, JavaBean等功能的支持.
关于这些标签更详细的描述在WebWork标签库附录中: 非UI标签, UI标签.示例
介绍如何在WebWork使用JSP视图技术的最佳方式是学习一个简单但完整的例子. 我们考察的例子实际上是一个网上商店应用, 如果你已经部署了WebWork的例子, 就可以在index.jsp中找到它. WebWork提供了许多例子以便人们更好的理解它的特性和能力. 网上商店应用是一个绝好的例子, 因为它使用了大量WebWork特性.在进入示例细节之前, 先看一下应用的用例(use case). 下面的列表展示了订购CD的流程.
- 应用引导用户选择语言.
- 为用户提供CD列表. 列表中包含了每个CD的唱片名, 艺术家, 和价格.
- 用户选择想要的CD及数量将它们放入购物车.
- 用户继续向购物车中添加或删除CD.
- 用户想要订货时将进行核对, 这时需要显示购物车中的内容.
- 如果愿意的话用户可以再次购物.
第一步 - 用户选择语言
让我们开始浏览应用. 当你在示例索引页面种选择该应用时, 它将连接到webwork/i18n/index.jsp. 通过查看该页面, 我们知道它将转向活动 - i18n.Language.action. 缺省情况下, WebWork将*.action映射到ServletDispatcher. 该类负责获取适当的活动类并执行它. 如果执行结果被指定到一个视图(JSP), 将转向该视图.
ServletDispatcher通过解析请求URI来决定使用哪一个活动类. 本例中, URI是i18n.Language.action. 该URI直接映射到webwork.action.test.i18n包中的类Language. 注意URI并不是 webwork.action.test.i18n.Language.action而仅仅是i18n.Language.action. 这时因为我们在webwork.properties文件中重新定义了 webwork.action.packages属性. 这允许在任何活动前使用前缀webwork.action.test.webwork.action.packages=webwork.action.test, webwork.action.standard
现在查看活动Language. 第一个发现是它扩展了Shop(Shop扩展了ActionSupport). 该类是一个你将多次使用的基类. 我们将在后面看到, 该类提供了一组有用的功能. 另外, 它提供了执行的缺省流程. 缺省情况下活动将执行execute方法. 当在ActionSupport类执行execute时, 它将判断URI是否有一个命令后缀如!foo. 本例中foo是需要执行的命令. 该命令将被转换成doFoo()方法调用, 由ActionSupport在活动中调用. 这允许你调用活动中的方法.
我们的URI不是一个命令, 因此ActionSupport将首先调用doValidate()方法. 这允许你在执行前完成校验. 由于我们没有该方法, ActionSupport将调用doExecute(). 本例中, Language监察是否已经设置了语言. 如果没有, 将返回ERROR. ServletDispatcher查找与i18n.Language.error对应的视图. 查看WEB-INF/classes目录下的views.properties文件, 可以找到应用的设置信息如下. 对于该错误, 可以查到它对应于langauge.jsp.因此dispatcher将转向该页面.
Webshop view mapping:# Webshop (I18N example adaptation) i18n.Shop.success=shop.jsp i18n.Add.success=shop.jsp i18n.Delete.success=shop.jsp i18n.Checkout.success=checkout.jsp i18n.Language.success=shop.jsp i18n.Language.error=language.jsp i18n.Restart.success=shop.jsp i18n.Cart.success=cart.jsp i18n.CDList.success=cdlist.jsp
那么当活动被提取出来时真正发生了什么? 缺省情况下, WebWork使用DefaultActionFactory作为ActionFactory. 该工厂和其他链接一起的工厂将被调用并视图完成活动获取.
以Language为例. Dispatcher将调用DefaultActionFactory并要求它返回对应的活动. 该工厂把请求放在链上. 一旦放在链上, 每一个工厂要么忽略请求, 要么对活动进行某些处理, 也可以返回活动. 下面的列表是DefaultActionFactory包含的工厂代理.- ParametersActionFactoryProxy - 为匹配的参数调用活动的Setter方法.
- PrepareActionFactoryProxy - 调用活动的prepare()方法. 允许活动在校验或执行前完成任何需要的准备活动.
- ContextActionFactoryProxy - 设置活动上下文(context). 活动可以实现*Aware接口通知代理需要设置哪些内容.
- CommandActionFactoryProxy - 剥去URI中的命令并将命令设置到活动中.
- AliasingActionFactoryProxy - 如果URI是一个别名, 将获取活动名称.
- JspActionFactoryProxy - 将JSP包装成活动.
- PrefixActionFactoryProxy - 使用配置文件中的前缀查找活动类.
- XMLActionFactoryProxy - 获取一个XML活动.
- ScriptActionFactoryProxy - 包装并执行JavaScript.
- JavaActionFactory - 返回适当的Java活动对象.
如你所见, 在DefaultActionFactory的盖头下发生了许多事情. 让我们回到例子中开始查看选择语言的页面language.jsp. 在这个页面中, 使用单选按钮(radio button)显示了一组语言列表. 让我们进一步产看绘制控件的代码.
<webwork:action name="'i18n.LanguageList'"> <ui:radio label="'Language'" name="'language'" list="languages"/> </webwork:action>
首先注意非UI标签action. 该标签执行活动LanguageList. 执行时, 该类将加载locale-to-language映射表并保存到属性languages中. 该标签随后将活动对象放入值栈以便引用.
现在看看UI标签radio. 该标签创建一个HTML的INPUT控件, 类型为radio. 控键的名字是language, 控件的文本是Language. 控件的值来自于活动LanguageList的getLanguages()方法调用. 该标签随后遍历映射表将键值作为VALUE属性, 映射值作为显示的文本.现在用户可以选择语言并提交表单. 表单被再次提交到活动Language. 这一次请求参数language包含在请求中. 当活动再次创建时, ParametersActionFactoryProxy将调用活动的setter方法. 这意味着调用方法setLanguage(). 现在, 当doExecute()执行时会发现用户已经选择了语言, 这时将创建对应的Locale对象并将它放入用户的session中.
session.put("locale", locale);
注意将信息放入session是多么的简单. 但session属性是从哪来的呢? 记住活动继承了Shop而该类实现了SessionAware接口. 因为SessionAware包含的setSession()方法将被调用来设置用户的session. 现在我们将locale放入session并返回SUCCESS. Dispatcher将查找别名为i18n.Language.success并发现它映射为shop.jsp. 用户将被转到该页面开始购物.
第二步 - 显示CD列表
在这一步中, 用户已经选择了语言并将locale对象放入session. 用户现在在shop.jsp中. 查看该页面的代码我们发现几处使用了非UI标签text. 该标签从资源包中提取文本. 该标签能识别locale并使用适当的资源包获取正确的文本.
<webwork:text name="'main.title'"/>
我们也注意到该页面包含另一个页面i18n.CDList.action. 非UI标签include将调用活动CDList如果成功的话将在页面中包含cdlist.jsp. 活动CDList将从文本文件中加载CD列表并放入list. CD列表加载完毕后我们将注意力转移到页面cdlist.jsp
CD:<webwork:include page="i18n.CDList.action" />
cdlist.jsp提供一个SELECT表单控件.
本例中, 我们不使用WebWork的UI标签select. 我们使用WebWork的非UI标签iterator来创建SELECT控件. 该标签可以遍历CD列表. 那么CD列表从哪里来呢? 记住, 在此之前我们调用了CDList. 活动调用后, WebWork将活动放入值栈以便视图引用. 因此, 我们将使用活动CDList的方法getCDList(). 该方法返回list而iterator标签将遍历它. 每一次迭代都将输出一个OPTION元素. 还需要注意非UI标签property. 对于列表中的每一个成员, property标签从CD中取出唱片名, 艺术家, 和国家. 还需要注意最后一个property使用活动ComputePrice来决定CD的价格. 语义@pricer/computePrice(price)意味着调用对象pricer的getComputePrice方法并将CD的价格作为参数. 非常酷. 
<webwork:action name="'webwork.action.test.i18n.ComputePrice'" id="pricer"/> <select name="album"> <webwork:iterator value="CDList"> <option value="<webwork:property value="album"/>"> <webwork:property value="album"/>, <webwork:property value="artist"/>, <webwork:property value="country"/>, <webwork:property value="@pricer/computePrice(price)"/> </option> </webwork:iterator> </select>
现在回到shop.jsp. 查看代码进一步展示的其他有趣的方面. 看看UI标签textfield的label属性. 注意属性的值是方法调用text('main.qtyLabel'). 该方法从资源文件中获取对应的字符串. 但是活动有getText()方法吗? 记住Shop扩展了ActionSupport. 该活动提供该方法.
<ui:textfield label="text('main.qtyLabel')" name="'quantity'" value="1" size="3"/>
shop.jsp中最后一个值的关注的内容是它包含了用户购物车.
<webwork:include value="'cart.jsp'" />
当cart.jsp(见下文)被包含时, 使用下面的代码取得用户购物内容. 属性value的值被转换成一组方法调用getCart()/getItems(). Shop调用的第一个方法将返回Cart, 然后在Cart上调用下一个方法. 如果第一个方法没有取得cart, Shop将创建一个空的cart并放入用户session.
<webwork:property value="cart/items"> <webwork:if test="."> <center> <table border="0" cellpadding="0" width="100%" bgcolor='<webwork:text name="'cart.bgcolor'"/>'> <tr> <td><b><webwork:text name="'cd.albumLabel'"/></b></td> <td><b><webwork:text name="'cd.artistLabel'"/></b></td> <td><b><webwork:text name="'cd.countryLabel'"/></b></td> <td><b><webwork:text name="'cd.priceLabel'"/></b></td> <td><b><webwork:text name="'cd.quantityLabel'"/></b></td> <td></td> </tr> <webwork:action name="'i18n.ComputePrice'" id="pricer"/> <webwork:iterator> <tr> <webwork:property value="cd"> <td><b><webwork:property value="album"/></b></td> <td><b><webwork:property value="artist"/></b></td> <td><b><webwork:property value="country"/></b></td> <td><b><webwork:property value="@pricer/computePrice(price)"/></b></td> </webwork:property> <td><b><webwork:property value="quantity"/></b></td> <td> <form action="i18n.Delete.action" method="post"> <input type=submit value='<webwork:text name="'cart.delLabel'"/>'> <input type=hidden name="album" value='<webwork:property value="cd/album"/>'> </form> </td> </tr> </webwork:iterator> </table> <p> <p> <form action="i18n.Checkout.action" method="post"> <input type="submit" value='<webwork:text name="'cart.checkoutLabel'"/>'> </form> </center> </webwork:if> </webwork:property>
